Skip to main content

1. CashLogy

Son unos cajeros automatizados con gestión de cobro y devolución de cambio.

2.1 CashLogyConnector​

Es un software intermedio que se comunica con un dispositivo Cashlogy físico o simulador conectado en el dispositivo. Su instalación es imprescindible.
Los programas que quieren controlar un dispositivo Cashlogy deben hacerlo mediante mensajes enviados a la IP y puerto de escucha de CashlogyConnector, el cual, según los comandos recibidos, mostrará pantallas con las cuales el usuario puede o no interactuar para gestionar la operación en curso.

2.2 Simulador CashLogy​

Es un programa sencillo que muestra el tipo de operación que se está realizando y que dispone de botones que representan la introducción de monedas o billetes para simular un pago. Además, también muestra el efectivo dispensado en operaciones de devolución de cambio o de vaciado.

2.3 IntegracionCashLogy​

Ofrece una serie de funcionalidades para poder interactuar con CashlogyConnector de forma más sencilla a través de la clase Cashlogy, la cual encapsula las operaciones que se pueden realizar con el dispositivo.
Tanto las cadenas de texto que CashlogyConnector espera recibir como las que emite son contenidas en un Mensaje que toma la forma de un comando o respuesta parametrizado para facilitar tanto su lectura como escritura.
Todos los mensajes enviados y recibidos se gestionan internamente a través de la clase ConexionSocket, permitiendo que solo se tenga que proporcionar la IP, socket y timeouts de envío y recepción de nuestra instancia de Cashlogy.

2.3.1 ConexionSocket​

Clase que la instancia de Cashlogy usa para el envío y recepción de respuesta de todos los comandos que implementa.
Se encarga de gestionar las conexiones a un socket definido por IP y puerto, y el envío y recepción de cadenas de texto en un tiempo determinado por timeouts de envío y recepción.

2.3.2 Mensaje​

CashlogyConnector espera recibir y envía cadenas de texto en el formato "#comando/codigoError#parametro1#parametro2#parametro3#...#parametroX#" y con un número de parámetros determinado por el primer parámetro (comando) o contexto (respuesta a un comando).
Esta clase es la base de herencia para todos los comandos y respuestas que gestionan el formato descrito anteriormente.
Un Mensaje se divide en dos bloques:

  • Tipo: Cadena de caracteres que para los comandos indica el tipo de comando y para las respuestas el código de error producido durante la ejecución de un comando previo o "0" en caso contrario.
  • Contenido: Lista de cadenas de caracteres para cada uno de los demás parámetros.

Tanto los comandos como las respuestas sirven para dar significado y gestionar el tipo de los distintos parámetros del Contenido según el comando o respuesta de CashlogyConnector que representan (6.3 COMANDOS en la documentación de CashLogyConnector).

2.3.3 CashLogy​

Clase principal de la IntegracionCashLogy que permite crear instancias que establecen una conexión con el CashLogyConnector.
Para ello, se deben proporcionar en la instanciación la IP y socket de escucha de CashlogyConnector, así como los timeouts de envío y recepción de mensajes, aunque los timeouts se podrán reasignar antes de ejecutar cualquier comando.
Estas instancias permiten realizar operaciones con el dispositivo CashLogy conectado con CashlogyConnector mediante funciones que se encargan de transmitir el comando y esperar la respuesta.
Las operaciones realizadas, según la complejidad de su comando y/o de su respuesta, recibirán parámetros de entrada y/o salida con el tipo de mensaje indicado.
Las operaciones que permite son:

  • (Inicializar) Comando de Inicializar la máquina: Operación necesaria para inicializar el dispositivo. Se deberá ejecutar solo una vez al inicio para inicializar la máquina. Cashlogy y Azkoyen RBH500 necesitan aproximadamente un minuto para iniciar, por lo tanto, la respuesta se demorará al menos este tiempo.

  • (Finalizar) Finalizar la aplicación CashlogyConnector: Operación que deberá enviarse al cerrar el software TPV para cerrar la aplicación CashlogyConnector.exe y finalizar la conexión con el cajón automático.

  • (Cobrar) Cobrar: Operación para realizar el cobro de una operación en la que el software TPV indicará el importe a cobrar y será CashlogyConnector quien gestionará el cambio en función del importe introducido. CashlogyConnector tendrá el control de toda la operación mostrando al usuario sus propias pantallas.

  • (BackOffice) BackOffice: Operación que aglutina en un solo menú todas las funciones de BackOffice del dispositivo en el que, dependiendo del tipo de usuario, se podrán mostrar las opciones que el software TPV considere oportunas. También estas funciones pueden ser llamadas directamente por el software TPV proporcionando mayor control.

  • (Dispensar) Dispensar: Mediante esta operación, el dispositivo devolverá el importe solicitado por el software TPV con la cantidad de monedas y billetes óptima según el caso.

  • (EstadoCashLogy) Estado: Presenta en una pantalla de CashlogyConnector los billetes y monedas con los que puede operar el dispositivo, e informa de la cantidad de cada denominación que está almacenada en ese momento en el dispositivo, tanto en los dispositivos recicladores como en los almacenes.

  • (AnadirCambios) Añadir cambios: Esta operación permitirá la introducción de monedas y billetes para ser utilizados como cambios en posteriores operaciones. En el primer uso y cuando la máquina está vacía, será necesario introducir cambio utilizando este comando antes de ningún otro que implique la introducción de monedas y billetes.

  • (DispensarPorDenominacion) Dispensar por denominación: Mediante esta operación, el dispositivo devolverá las cantidades de monedas y billetes indicadas por el software TPV sin mostrar la pantalla de CashlogyConnector.

  • (CantidadTodasDenominaciones) Cantidad de todas las denominaciones: Operación para consultar a CashlogyConnector la cantidad total almacenada de cada denominación.

  • (CantidadTotalEfectivo) Cantidad total de efectivo: Operación para consultar a CashlogyConnector el importe total del efectivo almacenado.

  • (CancelarOperacionEnCurso) Cancelar: El software podrá en todo momento cancelar la operación que se está ejecutando. Esta operación será siempre prioritaria y detendrá la operación que se esté desarrollando. Si un billete/moneda ya ha empezado a ser dispensado/admitido, el dispositivo terminará dicha operación.

  • (Reset) Reset: Esta operación reinicializará el sistema y podrá ser lanzada por el software POS en cualquier momento, incluso en estado “busy”. Es la operación que deberá usarse para finalizar una pantalla de CashlogyConnector sin la interacción del usuario.